home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Systemmonitors / SDB / SDB.DOC < prev    next >
Text File  |  1996-09-26  |  11KB  |  271 lines
  1. Short: Ultimate (?) system monitor for Amiga
  2.  
  3.  
  4.                ********* The SuperDashBoard *********
  5.                
  6.                     by Marat Sh. Fayzullin (FMS)
  7.  
  8.                     version 1.1  (C)FMS 6/6/1993
  9.  
  10.              This program is SHAREWARE. If you like it,
  11.              send US$15 to address given in the end of
  12.              this file to receive the LATEST UPDATE. 
  13.  
  14.  
  15.     Now includes:   1. CPU and RAM gauges and graphs 
  16.                        (like the first DashBoard)
  17.                     2. Magnifier
  18.                     3. General system info
  19.                     4. Browsers for:
  20.                            Libraries
  21.                            Screens
  22.                            Windows
  23.                            Fonts
  24.                            RasterPorts
  25.                            Volumes
  26.                            Devices *
  27.                            Assigns *
  28.                            
  29.                        * currently under development
  30.  
  31.  
  32. I. SuperDashBoard (SDB): What it is and how it appeared:
  33.  
  34.    Well, as you may already suspect, there was an earlier program
  35. called DashBoard (DB). DB was a simple system monitor a la Perf, 
  36. PerfMeter and SpySys showing CPU load and free RAM amount. DB employed
  37. graphs and nice gauges to display all these parameters. It also showed
  38. current time.
  39.    Unlike DB, SDB is an attempt to create something much more universal:
  40. in addition to the standard DB features it has a magnifier which can be
  41. used for any screen and a bunch of system browsers allowing to see what
  42. this or that program does. Browsers are interlinked with each other so
  43. that you can easily find any detail. So, you can get to RastPort
  44. information from the Screen browser and then check the Font current for
  45. this RastPort by simple pressing the button. Even if you aren't curious
  46. about system matters, you may find other SDB's features like a magnifier
  47. or CPU load meter useful.
  48.    The main difference between SDB and other system monitors is that it
  49. tries to be as comprehensible and easy to use as possible. I took Mac's
  50. ResEdit as an example and attempted to visualize any useful piece of
  51. information which Amiga's system structures contain.
  52.    This is the first version of SDB. Some of its parts are not developed
  53. yet and I'm sure it has lots of bugs. See "TO DO" chapter for details.
  54. Feel free to send your comments, flames, suggestions to fms@wam.umd.edu.
  55. Do not forget about small donation of $15US which will allow me to 
  56. continue writing Amiga software instead of spending time for some
  57. unproductive part-time job.
  58.  
  59.  
  60.  
  61. II. How to use SDB:
  62.  
  63.    After some frustrated attempts to write something useful in here I
  64. decided to limit the instructions to one sentence: 
  65.  
  66.      IT IS PRETTY SIMPLE: YOU JUST CLICK LEFT MOUSE BUTTON ON
  67.            ANY GADGET YOU SEE AND WATCH WHAT HAPPENS!
  68.  
  69.    Nevertheless, there are some features in SDB which aren't quite
  70. obvious for everybody. In this case, you sometimes have to give up and
  71. look into the manual. So, here is a list of possible problems you may
  72. have and their explanations:
  73.  
  74. 1. How to get elaborate information on the screen, library, etc.?
  75.  
  76.    Click on the [Volumes],[Libraries],[Screens],[Fonts],[Devices] or
  77. [Assigns] gadget in the Main window. Then click on the object name in the
  78. list to get more information about this object.
  79.  
  80. 2. Where is information on Devices and Assigns?
  81.  
  82.    It is not available in SDB v.1.1 but it will be available in the
  83. later versions.
  84.  
  85. 3. [Refresh] menu of the Main window:
  86.  
  87.    Refresh All - Refresh all windows once  
  88.    AutoRefresh - Turn autorefresh on/off
  89.    
  90. 4. Magnifier:
  91.  
  92.    Magnifier shows the part of the current active screen under the mouse
  93. pointer. If this screen has more bitplanes than the screen SDB is working
  94. on, the exceeding bitplanes will be ignored. You will also get less colors
  95. if there is not enough memory for all bitplanes. Also, don't worry about
  96. the colors: Magnifier always uses palette of the screen its window is on so
  97. color matching is not guaranteed. Magnifier has its own menus allowing to
  98. change magnification factors. Its window refreshes with the same rate as
  99. other windows do. Also, you may notice slight jerkiness of the picture
  100. when using 1:1 horizontal magnification: because of the problem with bitmap
  101. scaling in graphics.library, I had to round the X coordinate to the
  102. number dividable by 16 when X magnification is 1:1. This problem is not
  103. present with other magnification rates.  
  104.  
  105. 5. Library window:
  106.  
  107.    This window appears when you select a library from the list in the Main
  108. window. [<] and [>] buttons allow browsing through the list of libraries.
  109. [Flush] button causes SDB to attempt flushing the unused library. If
  110. attempt is succesful, the Library window disappears.
  111.  
  112. 6. Running multiple copies of SDB:
  113.  
  114.    Unlike DB, you can't run multiple copies of SDB. SDB checks if another
  115. copy of SDB is already running and exits if it is. This feature was
  116. added because multiple SDBs would interfere with each other showing wrong
  117. CPU parameters (as DBs do).
  118.  
  119. 7. Gauges window:
  120.  
  121.    [CPU] shows total CPU load
  122.    [RAM] shows total free RAM size (CHIP+FAST)
  123.    [F] shows free FAST RAM amount
  124.    [C] shows free CHIP RAM amount
  125.    
  126. 8. Blinking of some texts in SDB:
  127.  
  128.    I'm using standard GadTools' TEXT gadgets which sometimes blink when
  129. you refresh them (at least on my A2000). Please, don't be disturbed by
  130. this fact. Everything is OK.
  131.  
  132. 9. Refreshing windows:
  133.  
  134.    Automatic refreshing of all windows may take too much CPU time, so I
  135. made it optional. You may turn it ON/OFF by the menu option of the Main
  136. window. When Autorefresh is OFF, only selected windows (like Gauges or
  137. Graph) are updated automatically. There are also tooltypes to set
  138. autorefresh and its rate. They are described further in this text.
  139.  
  140. 10. What do question marks (???) mean?
  141.  
  142.    "???" means that SDB couldn't figure out the value of this or that 
  143. parameter. For example, if window doesn't have the title, SDB will show
  144. "???" instead of it. Also, SDB 1.1 isn't able to figure out the chipset
  145. name, so it displays "???" instead of it.
  146.  
  147. 11. Saving configuration:
  148.  
  149.    SDB saves windows' coordinates and some other information in the
  150. S:SDB.prefs file. Data from this file has higher priority than paramaters
  151. set by tooltypes. There is a sample configuration file included in SDB
  152. distribution. Copy it to S: if you want to use it.
  153.  
  154. 12. Font window:
  155.  
  156.    If font is too large, SDB doesn't show it. The [Flush] button allows
  157. to try flushing the font out of memory. If your attempt is succesfull,
  158. window should dissapear.  
  159.  
  160. 13. Enforcer hits:
  161.    
  162.    YES, SDB CAUSES ENFORCER HITS. I know no way to get rid of this 
  163. problem. The only thing which soothes me is that such program as ARTM also
  164. causes Enforcer hits.
  165.  
  166.  
  167.  
  168. III. Workbench Tooltypes:
  169.  
  170. TIME        = ON/OFF - Disables time display in the Gauges window.
  171.                        (Default = ON)
  172.  
  173. AUTOREFRESH = ON/OFF - Enables autorefresh feature for all windows.
  174.                        (Default = OFF)
  175.  
  176. REFRESH     = 1..100 - Sets autorefresh rate in 1/10s of the second.
  177.                        (Default = 10 for 1 second)
  178.  
  179. PRIORITY   = -10..10 - Sets SDBs priority.
  180.                        (Default = system default)  
  181.  
  182. SCREEN = <Public Screen> - Sets public screen to open SDB at.
  183.                            (Default = Workbench)
  184.  
  185. LIST  = LIBRARIES/ASSIGNS/VOLUMES/DEVICES/FONTS/SCREENS
  186.         Sets the initial type of the list in the Main window.
  187.         (Default = LIBRARIES) 
  188.  
  189. GRAPH = USAGE/IDLE/CHIPRAM/FASTRAM/TOTALRAM/SWITCH
  190.         Sets the initial type of the graph in the Graph window.
  191.         (Default = IDLE)   
  192.    
  193.    
  194.    
  195. IV. TO DO (bugs, improvements, etc.):
  196.  
  197.    There are no bugs I know about except for the memory fragmentation
  198. occuring when you resize the Magnifier window too frequently. It seems
  199. to be not my fault, rather C='s one. It is caused by the way AmigaDOS
  200. uses to free the memory released by the FreeMem() call. Another thing is
  201. that SDB WILL CAUSE ENFORCER HITS! SDB needs to access various areas of
  202. RAM not belonging to it and I don't know how to access random area of RAM
  203. without causing such hit. If you know the way to do it, tell me about it. 
  204.    If you find any other bugs or just notice strange behavior of the SDB,
  205. please, send email to fms@wam.umd.edu.
  206.  
  207.    This is the very first version of SDB so many things are not yet
  208. implemented. Here is the list of things I'm going to implement in the next
  209. version:
  210.  
  211.           1. Chipset field in the General Info window displays '???' in
  212.              this version of SDB. Next one will show the correct
  213.              abbreviation for the chipset. (Somebody, tell me how to
  214.              determine which chipset is installed!)
  215.           2. There will be special windows for the Assigns and Devices.
  216.           3. I'm going to create small RastPort/BitMap viewer displaying
  217.              entire RastPort/BitMap in the small resizable window.
  218.           4. There will be a browser for the Gadget structures.
  219.           5. I think there should be a window with many meters showing
  220.              free space on all drives in the system. I just can't find
  221.              the best way to display the meters without knowing how many
  222.              drives this or that system has.
  223.           6. Certainly, there is going to be a browser for the tasks and
  224.              processes.
  225.           7. It is likely that I will include a tiny hexadecimal memory
  226.              editor or just a memory browser (without editing capability). 
  227.           8. I don't promise to get rid of Enforcer hits but there may be
  228.              a Workbench tooltype allowing to disable all parts of SDB
  229.              capable of causing such hits. For example, when you set
  230.              ENFORCED=ON tooltype, all gadgets of the Main window which
  231.              invoke Enforcer-unfriendly features will be disabled. 
  232.           9. Of course, there will be a way to minimize the Main window.
  233.          10. There will be more graphics in the next version of SDB.
  234.  
  235. 4. Thanks to...
  236.  
  237.   Erik Wistrand
  238.     for his Scale program and a great way of fast bitmap-scaling.
  239.   Tony Leneis
  240.     for idea to check if another copy of DashBoard is already
  241.     running. This feature didn't make it into original DB but
  242.     it is implemented in SDB.
  243.   Mickey Everts 
  244.     who made many important suggestions about DashBoard.
  245.   Franz Josef Mertens 
  246.     whose ARTM program was somewhat of a prototype for SDB.
  247.   Juha Tuominen 
  248.     for his Perfmeter which inspired me to write DashBoard.
  249.  
  250.  
  251. 5. Address and Shareware conditions:
  252.  
  253.    This program is SHAREWARE. If you like it, PLEASE, send US$15 to
  254.    address given here:
  255.    
  256.                                  Marat Fayzullin
  257.                           8770 Cloudleap Court  Apt#24
  258.                              Columbia,    MD 21045       
  259.                                       USA
  260.  
  261.      E-Mail address:  fms@wam.umd.edu                
  262.  
  263.    Registered users will get regular updates.
  264.    
  265.    
  266.                                                  Marat Fayzullin (FMS)
  267.                                                        5/22/1993
  268. ---------------------------------------------------------------------------
  269. Everything able to rot - rots. Everything unable to rot - rots as well.
  270. ---------------------------------------------------------------------------
  271.